==========================
K-E
Programmed by Damian Grove
Compiled 02/10/2010
==========================

K-E is a level editor for Kid Chameleon on the Sega Genesis / Mega-Drive. The
tool is not yet complete, but new functionality and features are being added
to it all the time. I plan to offer many updates in the future.

There are two programs you can use. They are KidEdit and KidTool. They both
have specific purposes, but are both part of the K-E suite. I will detail them
both in the following paragraphs.



--------------------
KIDTOOL:
--------------------

This program allows you to import and extract map data to and from the Kid
Chameleon ROM. To use it, open a command prompt window or the Windows "Run"
dialog window. Then type (without quotes) "kidtool.exe rom.bin", followed by
any of the commands listed below. It is important to note the commands are
case-sensitive, so type them in lowercase. Where "rom.bin" is, you type the
name of your Kid Chameleon ROM. It must be in raw binary format.

COMMANDS:

-info XX
This command gives you basic information on a level, such as the size, name,
and the map number that cooresponds to it. Replace "XX" with a level number
using the hexadecimal format. Use two digits, and do not use any notation.

-map XX
This will decompress a map and save it in a file with the "KCM" extension.
There's a difference between level and map numbers. A map number is assigned
to each level. For example, map 4A is assigned to level 00. This is the method
Kid Chameleon designers used to order the levels from first to last.

-block XX
When used with the command above, only specific type of block will be dumped
in the map. The block types are as follows:

00 - Rock
01 - Prize
02 - Ice
03 - Ghost
04 - Telepad
05 - Iron
06 - Rubber
07 - Shifting
08 - (unused)
09 - Mushroom
0A - Vanishing/Cannon
0B - Lift
0C - Drill
0D - (unused)
0E - (unused)
0F - (unused)
10 - Collision

-theme X
This will decompress a theme and save it with the "KCT" extension. A theme is
a collection of art data used for each level style. Themes are used by K-E to
display the levels properly. The themes are as follows:

1 - Sky
2 - Ice
3 - Hill
4 - Isle
5 - Desert
6 - Swamp
7 - Mountain
8 - Under
9 - Forest
A - Urban

-decompress XXXXXX
This is for more advanced users that wish to decompress specific areas of the
ROM. Nearly all the art used in the game is compressed, so this command can be
useful for decompressing this art (assuming you know exactly where it is).
Simply replace "XXXXXX" with the hexadecimal address pointing to the data in
the ROM you wish to decompress.

-resource
Use this command if something happens to the "kidedit.dat" file required by
KidEdit. It is likely to be of interest to anyone wishing to modify the source
code to KidEdit to add new functionality.

-import
This command allows you to import maps back into the ROM. It will search for
all mapXX.kcm files in the directory (XX being a map number up to 7D.) All of
the map data will be inserted at the 1MB mark in the ROM to avoid possible
issues with size.



--------------------
KIDEDIT:
--------------------

This is the K-E level editing tool. You can change nearly everything about a
level except the enemy and platform positions. KidEdit can either be run from
the command prompt, or you can simply drag a map onto the KidEdit icon. If you
wish to use the command prompt, type (without quotes) "kidedit.exe mapXX.kcm".
Where "mapXX.kcm" is, you type the filename of the map you want to load. Using
the command prompt, you also have the option of telling it to use a specific
theme. Simply add "themeX.kct" to the end of the command line, replacing it
with the filename of the theme you wish to use. KidEdit will automatically
select a theme if no theme is specified. Having the correct theme is required
to display the map properly.

The follows keys can be used to navigate your way through this program:

-Arrows
Navigate across the map

-Plus/Minus
Increase/decrease tile/block value by 1

-Asterisk/Slash
Increase/decrease tile by 16

-Open Brace/Close Brace
Move block property selector

-L
Linear block drawing mode (default)

-R
Rectangular block drawing mode

-C
Copy the tile under the cursor

-P
Paste tile

-Insert
Insert new block

-Delete
Set tile value to 0 / delete block

-U
Undo (up to 100 times)

-S
Save changes

-F1
Help

-F4
Full screen

-F8
Hide objects

-F9
Hide blocks

-F10
Holographic view

-F11
Hide HUD

-F12
Take a screen shot (saved as DUMP.BMP)

-Esc
Quit


Use the left mouse button to drag objects. The left mouse button is also used
to draw blocks (selected from the right-side pane.)



Please be aware that this program is still incomplete. There are features that
don't function as well as they could, and there are bugs.

If you have any questions related to K-E, send them to me via e-mail. You can
e-mail me at ymtx81z (AT) yahoo (DOT) com.
